---
title: Jira
description: Jiraとの連携
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="jira"
  color="#E0E0E0"
/>

{/* MANUAL-CONTENT-START:intro */}
[Jira](https://www.atlassian.com/jira)は、チームがアジャイルソフトウェア開発プロジェクトを効果的に計画、追跡、管理するのに役立つ、主要なプロジェクト管理および課題追跡プラットフォームです。Atlassianスイートの一部として、Jiraは世界中のソフトウェア開発チームやプロジェクト管理の専門家にとって業界標準となっています。

Jiraは、柔軟でカスタマイズ可能なワークフローシステムを通じて、複雑なプロジェクトを管理するための包括的なツールセットを提供します。強力なAPIと統合機能により、チームは開発プロセスを効率化し、プロジェクトの進捗状況を明確に把握することができます。

Jiraの主な機能には以下が含まれます：

- アジャイルプロジェクト管理：カスタマイズ可能なボードとワークフローによるスクラムとカンバン手法のサポート
- 課題追跡：バグ、ストーリー、エピック、タスクの詳細なレポート機能を備えた高度な追跡システム
- ワークフロー自動化：繰り返しのタスクやプロセスを効率化する強力な自動化ルール
- 高度な検索：複雑な課題のフィルタリングとレポート作成のためのJQL（Jira Query Language）

Simでは、Jira統合によりエージェントがプロジェクト管理ワークフローとシームレスに連携できます。これにより、AIワークフローの一部として課題の自動作成、更新、追跡の機会が生まれます。この統合により、エージェントはプログラムによってJiraの課題を作成、取得、更新することができ、プロジェクト管理タスクの自動化を促進し、重要な情報が適切に追跡・文書化されることを保証します。SimとJiraを連携させることで、プロジェクトの可視性を維持しながら日常的なプロジェクト管理タスクを自動化するインテリジェントなエージェントを構築し、チームの生産性を向上させ、一貫したプロジェクト追跡を確保することができます。
{/* MANUAL-CONTENT-END */}

## 使用手順

Jiraをワークフローに統合します。課題の読み取り、書き込み、更新が可能です。Jiraのウェブフックイベントに基づいてワークフローをトリガーすることもできます。

## ツール

### `jira_retrieve`

特定のJira課題に関する詳細情報を取得する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `domain` | string | はい | あなたのJiraドメイン（例：yourcompany.atlassian.net） |
| `projectId` | string | いいえ | JiraプロジェクトID（オプション；単一の課題を取得する場合は不要） |
| `issueKey` | string | はい | 取得するJira課題キー（例：PROJ-123） |
| `cloudId` | string | いいえ | インスタンスのJira Cloud ID。提供されない場合、ドメインを使用して取得されます。 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | 操作成功ステータス |
| `output` | object | 課題キー、要約、説明、作成日時、更新日時を含むJira課題の詳細 |

### `jira_update`

Jira課題を更新する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `domain` | string | はい | あなたのJiraドメイン（例：yourcompany.atlassian.net） |
| `projectId` | string | いいえ | 課題を更新するJiraプロジェクトID。提供されない場合、すべての課題が取得されます。 |
| `issueKey` | string | はい | 更新するJira課題キー |
| `summary` | string | いいえ | 課題の新しい要約 |
| `description` | string | いいえ | 課題の新しい説明 |
| `status` | string | いいえ | 課題の新しいステータス |
| `priority` | string | いいえ | 課題の新しい優先度 |
| `assignee` | string | いいえ | 課題の新しい担当者 |
| `cloudId` | string | いいえ | インスタンスのJira Cloud ID。提供されない場合、ドメインを使用して取得されます。 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | 操作成功ステータス |
| `output` | object | タイムスタンプ、課題キー、要約、成功ステータスを含む更新されたJira課題の詳細 |

### `jira_write`

Jira課題を作成する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `domain` | string | はい | あなたのJiraドメイン（例：yourcompany.atlassian.net） |
| `projectId` | string | はい | 課題のプロジェクトID |
| `summary` | string | はい | 課題の要約 |
| `description` | string | いいえ | 課題の説明 |
| `priority` | string | いいえ | 課題の優先度 |
| `assignee` | string | いいえ | 課題の担当者 |
| `cloudId` | string | いいえ | インスタンスのJira Cloud ID。提供されない場合、ドメインを使用して取得されます。 |
| `issueType` | string | はい | 作成する課題のタイプ（例：タスク、ストーリー） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | 操作成功ステータス |
| `output` | object | タイムスタンプ、課題キー、要約、成功ステータス、URLを含む作成されたJira課題の詳細 |

### `jira_bulk_read`

複数のJira課題を一括で取得する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `domain` | string | はい | あなたのJiraドメイン（例：yourcompany.atlassian.net） |
| `projectId` | string | はい | JiraプロジェクトID |
| `cloudId` | string | いいえ | Jira cloud ID |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | 操作成功ステータス |
| `output` | array | 概要、説明、作成日時、更新日時を含むJiraの課題の配列 |

### `jira_delete_issue`

Jira課題を削除する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `domain` | string | はい | あなたのJiraドメイン（例：yourcompany.atlassian.net） |
| `issueKey` | string | はい | 削除するJira課題キー（例：PROJ-123） |
| `deleteSubtasks` | boolean | いいえ | サブタスクを削除するかどうか。falseの場合、サブタスクを持つ親課題は削除できません。 |
| `cloudId` | string | いいえ | インスタンスのJira Cloud ID。提供されない場合、ドメインを使用して取得されます。 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | 操作成功ステータス |
| `output` | object | タイムスタンプ、課題キー、成功ステータスを含む削除された課題の詳細 |

### `jira_assign_issue`

Jira課題をユーザーに割り当てる

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `domain` | string | はい | あなたのJiraドメイン（例：yourcompany.atlassian.net） |
| `issueKey` | string | はい | 割り当てるJira課題キー（例：PROJ-123） |
| `accountId` | string | はい | 課題を割り当てるユーザーのアカウントID。自動割り当てには"-1"を使用するか、割り当て解除にはnullを使用します。 |
| `cloudId` | string | いいえ | インスタンスのJira Cloud ID。提供されない場合、ドメインを使用して取得されます。 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | 操作成功ステータス |
| `output` | object | タイムスタンプ、課題キー、担当者ID、成功ステータスを含む割り当ての詳細 |

### `jira_transition_issue`

Jira課題をワークフローステータス間で移動する（例：To Do → In Progress）

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `domain` | string | はい | あなたのJiraドメイン（例：yourcompany.atlassian.net） |
| `issueKey` | string | はい | 移行するJira課題キー（例：PROJ-123） |
| `transitionId` | string | はい | 実行する移行のID（例：「11」は「To Do」、「21」は「In Progress」） |
| `comment` | string | いいえ | 課題を移行する際に追加するオプションのコメント |
| `cloudId` | string | いいえ | インスタンスのJira Cloud ID。提供されない場合、ドメインを使用して取得されます。 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | 操作成功ステータス |
| `output` | object | タイムスタンプ、課題キー、移行ID、成功ステータスを含む移行の詳細 |

### `jira_search_issues`

JQL（Jira Query Language）を使用してJira課題を検索する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `domain` | string | はい | あなたのJiraドメイン（例：yourcompany.atlassian.net） |
| `jql` | string | はい | 課題を検索するためのJQLクエリ文字列（例：「project = PROJ AND status = Open」） |
| `startAt` | number | いいえ | 返す最初の結果のインデックス（ページネーション用） |
| `maxResults` | number | いいえ | 返す結果の最大数（デフォルト：50） |
| `fields` | array | いいえ | 返すフィールド名の配列（デフォルト：['summary', 'status', 'assignee', 'created', 'updated']） |
| `cloudId` | string | いいえ | インスタンスのJira Cloud ID。提供されない場合、ドメインを使用して取得されます。 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | 操作成功ステータス |
| `output` | object | タイムスタンプ、合計数、ページネーション詳細、一致する課題の配列を含む検索結果 |

### `jira_add_comment`

Jira課題にコメントを追加する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `domain` | string | はい | あなたのJiraドメイン（例：yourcompany.atlassian.net） |
| `issueKey` | string | はい | コメントを追加するJira課題キー（例：PROJ-123） |
| `body` | string | はい | コメント本文テキスト |
| `cloudId` | string | いいえ | インスタンスのJira Cloud ID。提供されない場合、ドメインを使用して取得されます。 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | 操作成功ステータス |
| `output` | object | タイムスタンプ、課題キー、コメントID、本文、成功ステータスを含むコメント詳細 |

### `jira_get_comments`

Jira課題からすべてのコメントを取得する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `domain` | string | はい | あなたのJiraドメイン（例：yourcompany.atlassian.net） |
| `issueKey` | string | はい | コメントを取得するJira課題キー（例：PROJ-123） |
| `startAt` | number | いいえ | 返す最初のコメントのインデックス（デフォルト：0） |
| `maxResults` | number | いいえ | 返すコメントの最大数（デフォルト：50） |
| `cloudId` | string | いいえ | インスタンスのJira Cloud ID。提供されない場合、ドメインを使用して取得されます。 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | 操作成功ステータス |
| `output` | object | タイムスタンプ、課題キー、合計数、コメントの配列を含むコメントデータ |

### `jira_update_comment`

Jira課題の既存コメントを更新する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `domain` | string | はい | あなたのJiraドメイン（例：yourcompany.atlassian.net） |
| `issueKey` | string | はい | コメントを含むJira課題キー（例：PROJ-123） |
| `commentId` | string | はい | 更新するコメントのID |
| `body` | string | はい | 更新されたコメントテキスト |
| `cloudId` | string | いいえ | インスタンスのJira Cloud ID。提供されない場合、ドメインを使用して取得されます。 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | 操作成功ステータス |
| `output` | object | タイムスタンプ、課題キー、コメントID、本文テキスト、成功ステータスを含む更新されたコメントの詳細 |

### `jira_delete_comment`

Jira課題からコメントを削除する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `domain` | string | はい | あなたのJiraドメイン（例：yourcompany.atlassian.net） |
| `issueKey` | string | はい | コメントを含むJira課題キー（例：PROJ-123） |
| `commentId` | string | はい | 削除するコメントのID |
| `cloudId` | string | いいえ | インスタンスのJira Cloud ID。提供されない場合、ドメインを使用して取得されます。 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | 操作成功ステータス |
| `output` | object | タイムスタンプ、課題キー、コメントID、成功ステータスを含む削除の詳細 |

### `jira_get_attachments`

Jira課題からすべての添付ファイルを取得する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `domain` | string | はい | あなたのJiraドメイン（例：yourcompany.atlassian.net） |
| `issueKey` | string | はい | 添付ファイルを取得するJira課題キー（例：PROJ-123） |
| `cloudId` | string | いいえ | インスタンスのJira Cloud ID。提供されない場合、ドメインを使用して取得されます。 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | 操作成功ステータス |
| `output` | object | タイムスタンプ、課題キー、添付ファイルの配列を含む添付ファイルデータ |

### `jira_delete_attachment`

Jira課題から添付ファイルを削除する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `domain` | string | はい | あなたのJiraドメイン（例：yourcompany.atlassian.net） |
| `attachmentId` | string | はい | 削除する添付ファイルのID |
| `cloudId` | string | いいえ | インスタンスのJira Cloud ID。提供されない場合、ドメインを使用して取得されます。 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | 操作成功ステータス |
| `output` | object | タイムスタンプ、添付ファイルID、成功ステータスを含む削除の詳細 |

### `jira_add_worklog`

Jira課題に作業時間記録エントリを追加する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `domain` | string | はい | あなたのJiraドメイン（例：yourcompany.atlassian.net） |
| `issueKey` | string | はい | 作業ログを追加するJira課題キー（例：PROJ-123） |
| `timeSpentSeconds` | number | はい | 秒単位の作業時間 |
| `comment` | string | いいえ | 作業ログエントリのオプションコメント |
| `started` | string | いいえ | ISO形式のオプション開始時間（デフォルトは現在時刻） |
| `cloudId` | string | いいえ | インスタンスのJira Cloud ID。提供されない場合、ドメインを使用して取得されます。 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | 操作成功ステータス |
| `output` | object | タイムスタンプ、課題キー、作業ログID、秒単位の作業時間、成功ステータスを含む作業ログの詳細 |

### `jira_get_worklogs`

Jira課題からすべての作業ログエントリを取得する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `domain` | string | はい | あなたのJiraドメイン（例：yourcompany.atlassian.net） |
| `issueKey` | string | はい | 作業ログを取得するJira課題キー（例：PROJ-123） |
| `startAt` | number | いいえ | 返す最初の作業ログのインデックス（デフォルト：0） |
| `maxResults` | number | いいえ | 返す作業ログの最大数（デフォルト：50） |
| `cloudId` | string | いいえ | インスタンスのJira Cloud ID。提供されない場合、ドメインを使用して取得されます。 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | 操作成功ステータス |
| `output` | object | タイムスタンプ、課題キー、合計数、作業ログの配列を含む作業ログデータ |

### `jira_update_worklog`

Jira課題の既存の作業ログエントリを更新する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `domain` | string | はい | あなたのJiraドメイン（例：yourcompany.atlassian.net） |
| `issueKey` | string | はい | 作業ログを含むJira課題キー（例：PROJ-123） |
| `worklogId` | string | はい | 更新する作業ログエントリのID |
| `timeSpentSeconds` | number | いいえ | 秒単位の作業時間 |
| `comment` | string | いいえ | 作業ログエントリのオプションコメント |
| `started` | string | いいえ | ISO形式のオプション開始時間 |
| `cloudId` | string | いいえ | インスタンスのJira Cloud ID。提供されない場合、ドメインを使用して取得されます。 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | 操作成功ステータス |
| `output` | object | タイムスタンプ、課題キー、作業ログID、成功ステータスを含む作業ログ更新の詳細 |

### `jira_delete_worklog`

Jira課題から作業ログエントリを削除する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `domain` | string | はい | あなたのJiraドメイン（例：yourcompany.atlassian.net） |
| `issueKey` | string | はい | 作業ログを含むJira課題キー（例：PROJ-123） |
| `worklogId` | string | はい | 削除する作業ログエントリのID |
| `cloudId` | string | いいえ | インスタンスのJira Cloud ID。提供されない場合、ドメインを使用して取得されます。 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | 操作成功ステータス |
| `output` | object | タイムスタンプ、課題キー、作業ログID、成功ステータスを含む削除の詳細 |

### `jira_create_issue_link`

2つのJira課題間のリンク関係を作成する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `domain` | string | はい | あなたのJiraドメイン（例：yourcompany.atlassian.net） |
| `inwardIssueKey` | string | はい | インワード課題のJira課題キー（例：PROJ-123） |
| `outwardIssueKey` | string | はい | アウトワード課題のJira課題キー（例：PROJ-456） |
| `linkType` | string | はい | リンク関係のタイプ（例：「ブロック」、「関連」、「重複」） |
| `comment` | string | いいえ | 課題リンクに追加するオプションのコメント |
| `cloudId` | string | いいえ | インスタンスのJira Cloud ID。提供されない場合、ドメインを使用して取得されます。 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | 操作成功ステータス |
| `output` | object | タイムスタンプ、インワード課題キー、アウトワード課題キー、リンクタイプ、成功ステータスを含む課題リンクの詳細 |

### `jira_delete_issue_link`

2つのJira課題間のリンクを削除する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `domain` | string | はい | あなたのJiraドメイン（例：yourcompany.atlassian.net） |
| `linkId` | string | はい | 削除する課題リンクのID |
| `cloudId` | string | いいえ | インスタンスのJira Cloud ID。提供されない場合、ドメインを使用して取得されます。 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | 操作成功ステータス |
| `output` | object | タイムスタンプ、リンクID、成功ステータスを含む削除の詳細 |

### `jira_add_watcher`

更新に関する通知を受け取るためにJira課題にウォッチャーを追加する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `domain` | string | はい | あなたのJiraドメイン（例：yourcompany.atlassian.net） |
| `issueKey` | string | はい | ウォッチャーを追加するJira課題キー（例：PROJ-123） |
| `accountId` | string | はい | ウォッチャーとして追加するユーザーのアカウントID |
| `cloudId` | string | いいえ | インスタンスのJira Cloud ID。提供されない場合、ドメインを使用して取得されます。 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | 操作成功ステータス |
| `output` | object | タイムスタンプ、課題キー、ウォッチャーアカウントID、成功ステータスを含むウォッチャーの詳細 |

### `jira_remove_watcher`

Jira課題からウォッチャーを削除する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `domain` | string | はい | あなたのJiraドメイン（例：yourcompany.atlassian.net） |
| `issueKey` | string | はい | ウォッチャーを削除するJira課題キー（例：PROJ-123） |
| `accountId` | string | はい | ウォッチャーとして削除するユーザーのアカウントID |
| `cloudId` | string | いいえ | インスタンスのJira Cloud ID。提供されない場合、ドメインを使用して取得されます。 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | 操作成功ステータス |
| `output` | object | タイムスタンプ、課題キー、ウォッチャーアカウントID、成功ステータスを含む削除詳細 |

## 注意事項

- カテゴリー: `tools`
- タイプ: `jira`
